Screen

Screen properties

Name Description Inherited Exported to Kanzi Engine
Effective Data Context The data context in the current node that is resolved from data context properties and bindings No No
Locale Node locale No Yes
Metrics Type Defines the type of the coordinate system for the window metrics. No Yes
Orientation The orientation of the window. No Yes
Width Absolute width of the window in pixels No No
Height Absolute height of the window in pixels No No
Width Relative width of the window [0,1] No No
Height Relative height of the window [0,1] No No
Screen Resolution A selection of pre-defined absolute screen resolutions / a custom resolution No No

Screen available properties

Name Description Inherited Exported to Kanzi Engine
Disable KZB Export Disables the exporting of the item into KZB. Can be used for, e.g. letting items out from certain profiles. The disabled items are always included in preview. No No
Bindings The list of expression property bindings the item is part of No No
Brush Color Color for brush. Set alpha to 0 to disable brush. No Yes
Brush Texture Texture for brush. No Yes
Layout Height The height of the node when used in a layout. Overrides the default bounds of the item. No Yes
Layout Width The width of the node when used in a layout. Overrides the default bounds of the item. No Yes
Global Ambient Color The color that is multiplied automatically with the "Ambient" property of the materials in the scene. No Yes
Glyph Texture The automatic texture of the glyph cache No Yes
Font Color Sets the color of the text. No Yes
Texture1 Sets the second texture you want the Blit Render Pass to blit. No Yes
Texture2 Sets the third texture you want the Blit Render Pass to blit. No Yes
Texture3 Sets the fourth texture you want the Blit Render Pass to blit. No Yes
Texture0 Sets the first texture you want the Blit Render Pass to blit. No Yes
Blend Intensity Controls the intensity how materials are blended on top of the existing color.
Attached property enables overriding of the blend intensity of the used materials at render pass or object node level		 No Yes
Ambient Color The color of the material when no light are present No Yes
Diffuse Color The color of the material when it is lit by a light No Yes
Emissive Color The color of the light that is emitted from the material surface No Yes
Mask Texture Texture for masking other texture or color No Yes
Mask Texture Offset Sets an offset for mask in materials No Yes
Mask Texture Tiling Determines how many times mask is presented in material No Yes
Specular Color The color of the specular reflection No Yes
Specular Exponent Determines the size of the specular highlight No Yes
Texture The texture of the material No Yes
Texture Offset Sets an offset for texture in materials No Yes
Texture Tiling Determines how many times texture is presented in material No Yes
Blend Mode Controls how blending is performed. Attached property enables overriding of the blend mode of the used materials at render pass or object node level.
Use "Alpha: Automatic" setting to use premultiplied or non-premultiplied alpha depending on the value of "Use Premultiplied Alpha by Default" project setting.		 No Yes
Tags List of tags attached to the item No No
Data Context Source of data for this node and its descendants No Yes
Actual Layout Height The calculated height of the node when used in a layout. No Yes
Actual Layout Width The calculated width of the node when used in a layout. No Yes
Horizontal Margin Sets the horizontal space between this node and other nodes that are adjacent to this node in a layout.
To set the Horizontal Margin property fields in a binding use:
- Vector_X to access the Left property field
- Vector_Y to access the Right property field		 No Yes
Vertical Margin Sets the vertical space between this node and other nodes that are adjacent to this node in a layout.
To set the Vertical Margin property fields in a binding use:
- Vector_X to access the Bottom property field
- Vector_Y to access the Top property field		 No Yes
Bottom Image The image to use in middle of the bottom row. No Yes
Bottom-Left Image Image to use in the bottom-left corner. No Yes
Bottom-Right Image The image to use in the bottom-right corner. No Yes
Center Image The image to use in the center. No Yes
Left Image The image to use in the center-left. No Yes
Right Image The image to use in the center-right. No Yes
Top Image The image to use in the middle of the top row. No Yes
Top-Left Image The image to use in the top-left corner. No Yes
Top-Right Image The image to use in the top-right corner. No Yes
Focused Indicates whether the node has actives focus. No Yes
Logical Focus Indicates whether the node has logical focus. No Yes
Node.Path Node full path. No Yes
Is Value Changing Whether or the value is currently changing. No Yes
Maximum Value The maximum value that the range allows. No Yes
Minimum Value The minimum value that the range allows. No Yes
Normalized Value The current value normalized to range [0, 1]. No Yes
Step Value The minimum amount that the value of the range can change at a time. No Yes
Value The current value. No Yes
State Manager State Manager applied to the current node No Yes
Style Style applied to the current node No Yes
Maximum Distance From Curve The distance from the curve where hit testing succeeds. No Yes
Horizontal Padding Sets the padding spaces between the content and the left and right boundaries of the text block. No Yes
Vertical Padding Sets the padding spaces between the content and the top and bottom boundaries of the text block. No Yes
Baseline Font baseline in 3D space units. No Yes
Two Pass Rendering Defines whether the Text Block 3D is rendered in two passes.
Disabling the two pass rendering improves performance, but can cause invalid rendering results when glyph bounds overlap.		 No Yes
Font The font used to render the text. No Yes
Character Spacing Sets the character spacing in device-independent pixels. No Yes
Constrain Content Height Whether to cut out the last lines that do not fit within the boundaries of the text block. No Yes
Fixed Character Width When set, overrides the font advance widths to make each character take a fixed amount of space specified in device-independent pixels. No Yes
Font Material Sets the material whose shader is used to render the text. The shader must use the ContentTexture uniform which is automatically filled with glyph data. No Yes
Font Size Sets the size of the font in device-independent pixels. No Yes
Line Spacing Sets the line spacing in multiples of the normal line height of the selected font. No Yes
Overflow Sets the characters that represent the clipped text when the text string to be rendered is too long to fit in the node. No Yes
Remove Side Bearings Whether to position the leftmost characters of left-aligned text and rightmost characters of right-aligned text exactly within the boundary of the text block. No Yes
Text Sets the text content that the text block renders.
To create a line break press Shift+Enter.		 No Yes
Text Horizontal Alignment Sets the horizontal alignment of the text. No Yes
Text Vertical Alignment Sets the vertical alignment of the text. No Yes
Word Wrap Whether to break long text lines to multiple lines to make the text fit within the boundaries of the text block. No Yes
Opacity Opacity of the node. No Yes
Brush Modulate Color Modulation color for brush. Effects brush rendering that needs color modulation. No Yes
Brush Horizontal Tiling Horizontal Tiling for the brush. Affects the scale of texture coordinates. No Yes
Brush Vertical Tiling Vertical Tiling for the brush. Affects the scale of texture coordinates. No Yes
Export in Asset Package When enabled, this item is exported into asset package if this project is saved as one. No No
Horizontal Alignment The alignment in horizontal direction the node should use when it resides under a layout. No Yes
Vertical Alignment The alignment in vertical direction the node should use when it resides under a layout. No Yes
Calculated Offset Current relative offset of object in a grid list box, in proportional range [0, 1]. No Yes
Visible Amount in Parent Describes how much of an object is inside its parent. Can be used in shaders to implement fades. Calculated by the parent node. No Yes
Calculated Offset Current offset of item caluclated by the trajectory layout in proportional range [0, 1] (read-only). No Yes
Hit Testable When enabled, users can pick the object node from the active scene's default 3D camera. For example, hit testing is needed for button components to work. No Yes
Clip Children Specified whether or not the children should be clipped. Children whose bounding box is completely outside the bounding box of the parent are clipped.
The property is to be used with layout nodes. The children should only use transformation that contain only translation.		 No Yes
Focusable Indicates whether the node can receive focus. No Yes
Visible When disabled the scene graph node is not rendered No Yes
Transition Phase The phase of the transition. For example, use for pixel-based effects. No Yes
Description Add a description of the purpose of this item. To export descriptions
to a plain text file, select File > Export > Export Descriptions.
When you export the kzb file, this description is not included in the
exported file.		 No No
Host Name Containes the name of the host the node originates from. No Yes
Screen Clear Color If screen has a clear color, screen will be cleared with the specified color before all other rendering. Depth will be cleared to 1.0f and stencil will be cleared to 0. No Yes

Screen messages

Name Description Inherited Exported to Kanzi Engine
Click Occurs when the pointer is pressed and is released on top of the component and no other gesture has been recognized. No Yes
Click Begin Occurs when the pointer is pressed down on top of the component. No Yes
Click Cancel Occurs when a started click cancels. This occurs, for example, when user pressed button down and slides finger away and releases press. No Yes
Click Enter Occurs when the pointer or touch enters the click manipulator. No Yes
Click Leave Occurs when the pointer or touch leaves the click manipulator. No Yes
Long Press Occurs when the pointer is pressed down on the button and 500ms has been passed. No Yes
Multi Click Occurs when the pointer is pressed and released specified number of times (default 2) within specified amount of time (default 250ms) on top of the control. No Yes
On Attached This trigger is set off when the item is initialized. For example, when you add a node to the scene graph, or enter a state that contains this trigger. No Yes
On Property Change Occurs when a property is changed No Yes
On Timer Occurs when timer interval is elapsed No Yes
Animation Playback Completed Occurs when animation player completes animation playback. No Yes
Animation Playback Started Occurs when animation player starts animation playback. No Yes
Animation Playback Stopped Occurs when animation player stops animation playback. No Yes
Interpolation Completed Occurs when property target interpolator completes interpolation. No Yes
Button: Cancel Occurs when a finger is lifted outside of a button that was previously pressed. No Yes
Button: Down Occurs when the button is pressed. No Yes
Button: Enter Occurs when a finger that presses a button enters the button's area. No Yes
Button: Leave Occurs when a finger that presses a button leaves the button's area. No Yes
Button: Long Press Occurs when a long press on the button happens. No Yes
Button: State Toggled Occurs when the button's toggle state changes. No Yes
Drag And Drop Finished Occurs when drag and drop gesture has finished. No Yes
Drag And Drop Moved Occurs on finger move after successfully starting the drag and drop with long press. No Yes
Drag And Drop Started Occurs on successfull long press on the node. No Yes
Key Down Occurs when the user presses a specific key on their keyboard. No Yes
Key Up Occurs when the user releases a specific key on their keyboard. No Yes
List Box: Item Hidden Occurs when an item is unloaded from the working memory.
To set how many items you want to keep loaded in the working memory at a time, use the Keep Alive Item Count property.		 No Yes
List Box: Item Selected Occurs when an item is selected. No Yes
List Box: Item Visible Occurs when an item is loaded to the working memory.
To set how many items you want to keep loaded in the working memory at a time, use the Keep Alive Item Count property.		 No Yes
List Box: Scroll Finished Occurs when list box scrolling ends. No Yes
List Box: Scroll Started Occurs when list box scrolling starts. No Yes
List Box: Scrolled Occurs when list box is scrolled. No Yes
List Box: Target Changed Occurs when list box gets a new target item. No Yes
Pan Finished Occurs when finger is raised after recognized pan gesture. No Yes
Pan Moved Occurs when finger position has changed and has exceeded recognition thresholds. No Yes
Pan Started Occurs when finger is pressed down. Pan might still be canceled if the finger is released before it has exceeded the treshold. No Yes
Pinch Finished Occurs when fingers are raised after recognized pinch gesture. No Yes
Pinch Moved Occurs first when the scale or rotation threshold is exceeded and after that when the tracked touches have moved between updates No Yes
Pinch Started Occurs when finger is pressed down. Pinch might still be canceled if finger is released before the gesture has exceeded scale or rotate threshold. No Yes
Asynchronous Load Completed Occurs when asynchronous loading of resources from a prefab has been finished. No Yes
Range Concept: Value Change Finished Occurs when the range value stops changing. No Yes
Range Concept: Value Change Started Occurs when the range value starts changing. No Yes
Range Concept: Value Changed Occurs when the range value has changed. No Yes
Scroll Ended Occurs when the scroll position of a Scroll View node stops changing. No Yes
Scroll Started Occurs when the scroll position of a Scroll View node starts changing. No Yes
Scroll Zoomed Occurs when the zoom level of a Scroll View node changes. No Yes
Scrolled Occurs when the scroll position of a Scroll View node changes. No Yes
Snap Request Occurs when a Scroll View node requests snapping target from the hosting component. No Yes
User Scroll Ended Message Occurs when the user stops scrolling a Scroll View node. No Yes
User Scroll Started Occurs when the user starts scrolling a Scroll View node. No Yes
Entered State Occurs when a state manager has entered a state. No Yes
Left State Occurs when a state manager has left a state. No Yes
Toggle Button Group: Toggled Occurs when a button in the group is toggled on. No Yes
Button: Click Occurs when a finger is lifted on top of a button that was previously pressed and when a pressed button's repeat interval expires. No Yes
Toggle Button: Toggled Off Occurs when the toggle button is toggled off. No Yes
Toggle Button: Toggled On Occurs when the toggle button is toggled on. No Yes

See also

Setting the Screen node

Open topic with navigation